home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / telecomm / archivers / mcvert.lha / mcvert / mcvert.0 < prev    next >
Encoding:
Text File  |  1994-12-18  |  7.6 KB  |  265 lines
  1.  
  2.  
  3.  
  4. MCVERT(LOCAL)     MISC. REFERENCE MANUAL PAGES      MCVERT(LOCAL)
  5.  
  6.  
  7.  
  8. NAME
  9.      mcvert - BinHex 4.0 to MacBinary file conversion utility
  10.  
  11. SYNOPSIS
  12.      mcvert [-options] name... [[-options] name...]...
  13.  
  14. DESCRIPTION
  15.      The _m_c_v_e_r_t program translates MacIntosh files from one  for-
  16.      mat  to  another.   The  primary  formats in which MacIntosh
  17.      files are represented on non-Macs are:
  18.  
  19.      MacBinary:
  20.           An eight  bit  wide  representation  of  the  data  and
  21.           resource  forks  of  a  Mac file and of relevant Finder
  22.           information, MacBinary files are  recognized  as  "spe-
  23.           cial"  by  several MacIntosh terminal emulators.  These
  24.           emulators, using Kermit or Xmodem  or  any  other  file
  25.           transfer  protocol, can separate the incoming file into
  26.           forks and appropriately modify the Desktop  to  display
  27.           icons, types, creation dates, and the like.
  28.  
  29.      BinHex 4.0:
  30.           A seven bit wide representation of a Mac file with  CRC
  31.           error  checking, BinHex 4.0 files are designed for com-
  32.           munication of Mac files over  long  distance,  possibly
  33.           noisy, seven bit wide paths.
  34.  
  35.      PackIt:
  36.           PackIt files are actually  representations  of  collec-
  37.           tions of Mac files, possibly Huffman compressed.  Pack-
  38.           ing many small related files  together  before  a  Mac-
  39.           Binary  transfer or a translation to BinHex 4.0 is com-
  40.           mon practice.
  41.  
  42.      Text:
  43.           A MacIntosh ends each line of a plain text file with  a
  44.           carriage return character (^M), rather than the newline
  45.           character (^J) that some systems seem to prefer.  More-
  46.           over, a MacBinary file has prepended Finder information
  47.           that non-MacIntoshes don't need.
  48.  
  49.      Data, Rsrc:
  50.           A Data or Rsrc file is the exact copy of  the  data  or
  51.           resource fork of a MacIntosh file.
  52.  
  53.      It is the purpose of this program to  convert  to  the  Mac-
  54.      Binary  format files in other of the above formats, and vice
  55.      versa.
  56.  
  57. PARAMETERS
  58.      Exactly one of the following operations may be specified for
  59.      an input name:
  60.  
  61.  
  62.  
  63. Sun Release 4.1     Last change: May 5, 1987                    1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MCVERT(LOCAL)     MISC. REFERENCE MANUAL PAGES      MCVERT(LOCAL)
  71.  
  72.  
  73.  
  74.      x    BinHex  4.0  -  files  in  the  MacBinary  format   are
  75.           translated  to  BinHex  files, or vice versa.  The name
  76.           argument may be the name of a file to be converted or a
  77.           basename   to  which  an  appropriate  suffix  must  be
  78.           appended to get a filename.  If the conversion is  from
  79.           Binhex 4.0 to MacBinary, several files may comprise the
  80.           BinHex representation of the  Mac  file.   Rather  than
  81.           manually concatenate the files and manually delete mail
  82.           headers and other extraneous garbage, one  may  specify
  83.           the  names of the files in order and _m_c_v_e_r_t will do the
  84.           concatenating and deleting.  Conversely, in  converting
  85.           a  MacBinary file to BinHex 4.0 format for mailing over
  86.           long distances, one may be restricted to mail  messages
  87.           of  no  greater  that some fixed length.  In this case,
  88.           _m_c_v_e_r_t can automatically divide the  BinHex  file  into
  89.           pieces  and label each piece appropriately.  Option 'x'
  90.           is selected by default.
  91.  
  92.      r    Resource - files in the  MacBinary  format  with  empty
  93.           data  forks  and  nonempty resource forks are made from
  94.           ordinary data files, or vice versa.
  95.  
  96.      d    Data - files in the MacBinary format with nonempty data
  97.           forks  and  empty resource forks are made from ordinary
  98.           data files, or vice versa.
  99.  
  100.      u    Text - files in the MacBinary format with nonempty data
  101.           forks  and  empty resource forks are made from ordinary
  102.           data files, or vice versa.  Unix newline characters are
  103.           interchanged with MacIntosh carriage return characters,
  104.           and a newly created MacBinary file  has  creator  field
  105.           given by the MAC_EDITOR environment variable.
  106.  
  107. OPTIONS
  108.      p | q
  109.           If a BinHex to MacBinary conversion is taking place and
  110.           option 'p' is selected, any file of type "PIT " will be
  111.           unpacked into its constituent parts.  This option  does
  112.           not  recursively  unpack  "PIT " files packed in "PIT "
  113.           files.  If a MacBinary to BinHex conversion  is  taking
  114.           place,  this  option is currently ignored.  By default,
  115.           option 'q' is selected.
  116.  
  117.      U | D
  118.           When option 'U' is selected, the conversion that  takes
  119.           place  is  the  one suitable for Uploading files.  That
  120.           is, the conversion is from MacBinary to something  else
  121.           when  'U'  is  selected.  Conversely, option 'D', as in
  122.           Download, converts from something to MacBinary.  Option
  123.           'D' is the default.
  124.  
  125.      s | v
  126.  
  127.  
  128.  
  129. Sun Release 4.1     Last change: May 5, 1987                    2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. MCVERT(LOCAL)     MISC. REFERENCE MANUAL PAGES      MCVERT(LOCAL)
  137.  
  138.  
  139.  
  140.           Normally, _m_c_v_e_r_t prints to stderr information about the
  141.           files  it  is  creating.   Selecting  option 's', as in
  142.           silent, disables this reporting.  Option 'v', for  ver-
  143.           bose, is the default.
  144.  
  145. ENVIRONMENT VARIABLES
  146.      There are four environment variables one may use to  custom-
  147.      ize the behavior of _m_c_v_e_r_t slightly.
  148.  
  149.      MAC_EDITOR
  150.           The creator  of  MacBinary  text  files  produced  with
  151.           options  -uD.  The default is MACA, the creator type of
  152.           MacWrite.
  153.  
  154.      MAC_DLOAD_DIR
  155.           The MacBinary files created when option -D is  selected
  156.           are  placed in this directory.  The default is ".", the
  157.           current working directory.
  158.  
  159.      MAC_EXT
  160.           The MacBinary files created when option -D is  selected
  161.           are named according to the filename field stored in the
  162.           file header, with the name  extended  by  this  suffix.
  163.           The default is ".bin".
  164.  
  165.      MAC_LINE_LIMIT
  166.           The BinHex files created when option -U is selected may
  167.           be  no  longer  than  this many lines long.  Files that
  168.           would otherwise exceed this line limit  are  broken  up
  169.           into  several  files  with  numbers embedded into their
  170.           file names to show their order.   Each  such  file  has
  171.           "Start of part x" and "End of part x" messages included
  172.           where appropriate.
  173.  
  174. BUGS
  175.      It should be possible to discard bad input now and  success-
  176.      fully  translate good input later, but bad input mostly just
  177.      causes immediate termination.
  178.  
  179.      A more diligent person would support BinHex 3.0  and  BinHex
  180.      2.0  and BinHex 5000.0 B. C., but I've never seen anyone use
  181.      them in three years.  A more diligent person would  also  do
  182.      something  for  users  of  macget  and macput, but hopefully
  183.      someone will make those programs support the MacBinary  file
  184.      protocol.
  185.  
  186. SEE ALSO
  187.      xbin(1), macget(1), macput(1), xmodem(1), kermit(1)
  188.  
  189. AUTHOR
  190.      Doug Moore, Cornell University Computer Science.  Based upon
  191.      _x_b_i_n by Dave Johnson, Brown University, as modified by Guido
  192.  
  193.  
  194.  
  195. Sun Release 4.1     Last change: May 5, 1987                    3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. MCVERT(LOCAL)     MISC. REFERENCE MANUAL PAGES      MCVERT(LOCAL)
  203.  
  204.  
  205.  
  206.      van Rossum, and upon _u_n_p_i_t by Allan G.  Weber,  as  well  as
  207.      upon correspondence with several helpful readers of USENET.
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261. Sun Release 4.1     Last change: May 5, 1987                    4
  262.  
  263.  
  264.  
  265.